Description

This PR introduces the PropertySchemaCssColorRestriction class, which generates a regular expression (pattern) for validating CSS color values in API Platform property schemas, based on the Symfony CssColor constraint.

Technical Details

Supports multiple CSS color formats (hex, rgb, rgba, hsl, hsla, named colors, etc.).
Dynamically builds a single regex pattern combining all allowed formats, suitable for OpenAPI/JSON Schema documentation.

Example

With a given resource Theme

#[ApiResource]
class Theme
{
    private ?int $id = null;

    #[Assert\NotNull]
    #[Assert\CssColor(
        formats: Assert\CssColor::HEX_LONG,
    )]
    public ?string $backgroundColor = null;
}

The impact in the OpenApi Schema provide

{
  "Theme": {
    "type": "object",
    "properties": {
      "id": {
        "type": "integer",
        "readOnly": true
      },
      "backgroundColor": {
        "type": "string",
        "pattern": "^#(?:[0-9a-f]{6})$",
      }
    },
    "required": ["backgroundColor"]
  }
}